home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
CD ROM Paradise Collection 4
/
CD ROM Paradise Collection 4 1995 Nov.iso
/
system
/
shcpy201.zip
/
TCOPY.DOC
< prev
next >
Wrap
Text File
|
1994-11-16
|
13KB
|
378 lines
TRU-COPY
Release 2.0
by
W.G. Madison
W.G. Madison and Associates, Ltd.
Consultants / Information Systems
13819 Shavano Downs
San Antonio, TX 78230-5811
(210)492-2776
(Internet bmadison@crl.com)
(FIDOnet bill madison 1:387/800)
(CompuServe 73240,342)
PURPOSE:
The DOS COPY command has three major shortcomings:
1. DOS provides no facility for reliably verifying the valid-
ity of a file copying operation. The use of the DOS VERIFY
command or the /V switch on the COPY command parform a
check which is essentially valueless, particularly in the
presence of disk caching.
Normally, the only way to assure that the recording was
correct is to read the file after writing, and compare
(using, e.g., COMP) the output file byte for byte with the
input. For very long files this can result in unacceptable
delays.
2. When using the DOS COPY command, files are copied uncondi-
tionally -- possibly accidentally overwriting existing
files.
3. When using the usual DOS facilities, files can only be
moved from one subdirectory to another through a two step
process. First, the file must be COPY'd to the target
subdirectory; and second, it must be DELeted from the
source subdirectory.
TRU-COPY answers these three problems in a single efficient
program.
1. Whenever TRU-COPY copies a file, the source file's cyclic
redundency check (CRC) value is calculated during the
copying process. On completion of the copying, the desti-
nation file is read and the CRC re-calculated. If the two
do not compare, a warning is issued, the source file is
unconditionally preserved, and the destination file is
deleted.
TRU-COPY preserves the date/time stamp of the source file
in the destination file.
2. Whenever TRU-COPY copies a file, it first checks to see if
a file of the same name already exists in the target sub-
directory. If it does, the user is presented with the
option of allowing the copying to proceed, or skipping
that copy and proceeding to the next. (TRU-COPY can,
however, be directed to perform the copies uncondition-
ally, by use of a command line switch.)
3. TRU-COPY can also be instructed (again, using a command
line switch) to move a file from one subdirectory to
another. This action proceeds by the following rules:
a. If the source and destination subdirectories are on
the same device, then
i. If a file of the same name exists in the
target subdirectory, then TRU-COPY will
revert to the copying mode described above.
In this case, however, the file will be
deleted from the source subdirectory after
successful verification.
ii. If no file of the same name exists in the
target subdirectory, the file will be moved
directly, without copying.
b. If the source and destination directories are on
different devices, the MOVE will be accomplished by
a COPY, VERIFY, DELETE sequence as described above.
4. Beginning with release 2.0, when performing a MOVE (as
described above) TRU-COPY recognizes subdirectories in
SUBSTed, JOINed, or ASSIGNed drives, and will act
accordingly.
HISTORY AND BACKGROUND:
For those unfamiliar with CRCs, suffice to say that they are
very powerful generalizations of the more familiar 'parity check'
schemes, such as those which have been used at least since the
early days of digital magnetic tape recording.
-2-
As such, calculating the CRC of a block of data prior to its
transmission and again following transmission, and then comparing
the results of the two calculations, provides an excellent indi-
cation of whether the transmission process introduced any errors
into the data.
USAGE:
The syntax is similar to the DOS COPY command, except that
files cannot be concatenated during the copying process.
Usage is:
TCOPY [/[D][O]] [s-path]s-file [d-path][d-file]
where
[/D] is the optional delete-source-file switch
[/O] unconditionally overwrites existing target files
[s-path] is the optional source path (directory)
[d-path] is the optional destination path (directory)
s-file is the source file specification
[d-file] is the optional destination file specification
Notes:
1. If either path is omitted, the current path on the
appropriate device is assumed.
2. Path names may be either absolute or relative. For
example,
D:*.*
refers to all of the files in the current directory of
disk D:, and
FOO\BAZ.*
refers to all files named BAZ (regardless of the exten-
sion) in subdirectory FOO of the current directory.
For additional information concerning path names, please
refer to your DOS manual.
3. If [d-file] is omitted, *.* is assumed; i.e., the files
will be transferred with their names and extensions
preserved.
4. Files cannot be copied to themselves. Therefore,
[s-path]s-file
-3-
cannot refer to the same file as
[d-path][d-file]
5. TRU-COPY preserves the date/time of the source file.
SYSTEM REQUIREMENTS:
Hardware: PC/XT/AT or close compatible.
Software: DOS 2.0 and above. TRU-COPY uses some undocumented
features of DOS. It cannot, therefore, be guaranteed to work in
other environments (e.g., DR-DOS). The features used are, how-
ever, supposedly supported in the DOS compatibility mode of OS/2.
This has not been tested, however.
INSTALLATION:
If you are using DOS 2.x, TCOPY ***MUST*** be installed in
one of the directories specified in your PATH, and ***MUST NOT***
be renamed to anything else. If you are unfamiliar with the PATH
concept, please refer to your DOS reference manual.
If you are using DOS 3.x or later, these restrictions do not
apply. TCOPY may be installed anywhere, and renamed to anything.
AND FINALLY:
- The software described herein and the accompanying
documentation is copyrighted and the sole the property of
W. G. Madison and Associates, Ltd. All rights reserved.
- W. G. Madison and Associates, Ltd. reserves the right to
make improvements in the product described in this
documentation and/or to the documentation at any time and
without notice.
Distribution
TRU-COPY is specifically authorized for distribution on
public electronic bulletin boards, by individual copying, or by
ASP designated distributors. Any distribution thus made must be
in the form of this entire .ZIP file, including both the program
executable file and this documentation file. NO DISTRIBUTION FOR
A FEE (other than a nominal copying charge), IS AUTHORIZED
WITHOUT SPECIFIC WRITTEN PERMISSION OF THE COPYRIGHT HOLDER.
-4-
Limited Warranty
THE PROGRAM IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY
KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE. THE ENTIRE RISK AS TO QUALITY AND PERFORMANCE
OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE,
YOU ASSUME THE ENTIRE COST OF ALL NECESSARY SERVICING, REPAIR OR
CORRECTION. SOME STATES DO NOT ALLOW THE EXCLUSION OF IMPLIED
WARRANTIES SO THE ABOVE EXCLUSION MAY NOT APPLY TO YOU. THIS
WARRANTY GIVES YOU SPECIFIC LEGAL RIGHTS AND YOU MAY ALSO HAVE
OTHER RIGHTS WHICH VARY FROM STATE TO STATE.
Limitation of Remedies
IN NO EVENT WILL W. G. MADISON AND ASSOCIATES, LTD. BE
LIABLE FOR ANY DAMAGES INCLUDING ANY LOST PROFITS, LOST SAVINGS
OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
USE OR INABILITY TO USE SUCH PROGRAM EVEN IF W. G. MADISON AND
ASSOCIATES, LTD. HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
DAMAGES OR ANY CLAIM BY ANY OTHER PARTY.
License
A limited license is granted to any user of the program to
freely copy and distribute the product subject to the following
restrictions:
You may not:
- Sell and/or distribute the product for a fee, either alone
or along with other products, without express written per-
mission.
- Grant sublicense, leases, or other rights in the software
to others.
- Modify or remove the Copyright notice from the program,
diskette or the documentation.
- Modify the program, diskette or documentation and/or merge
it into another program for any machine.
Support
Users are provided full telephone support. A recorder is
provided on the telephone number listed above, in case no one is
in the office, and a callback will normally occur no later than
the next business day. Bug fixes or work-arounds will be mailed
to the complainant and will also be uploaded to CIS (IBMSYS) and
to major BBS's in the metropolitan San Antonio area.
-5-
Contact
Telephone contact may normally be made between the hours of
7:00AM and 9:00PM (Central time), but see above. Users will be
accommodated on a "time available" basis. Contact may, of course,
always be made at any of the network addresses given above. All
users are encouraged to submit comments about this program by
filling out the comment form on the following page, and mailing
it to the address indicated.
-6-
WGM&AL Comment Form
TRU-COPY
Name:___________________________________________________________
Company:________________________________________________________
Address:________________________________________________________
City:__________________________ State:_____ ZIP _______________
Telephone:(_____) _____-_______
TRU-COPY Version:_____._____
Comments:
Mail To:
W. G. Madison and Associates, Ltd.
13819 Shavano Downs
San Antonio, TX 78230-5811
(512)492-2776